home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / TW31.ZIP;1 / TWTUT1.CHP < prev    next >
Encoding:
Text File  |  1993-05-26  |  7.0 KB  |  203 lines
  1. %
  2. #EF
  3. #TTUTORIAL  DESIGN
  4. #C2,R6
  5. After you have decided what the subject of your ~M~Itutorial~N will be, the hardest
  6.  
  7. part of writing it is deciding what information you want to pass along to the
  8.  
  9. ~G~IReader~N, then getting that information organised into some manageable format.
  10.  
  11.  
  12.  
  13. One way to do this is to follow the ~C~IInstructional Design~N methodology and
  14.  
  15. in this Section of the ~H~bTutorialWriter~N ~M~Itutorial~N we'll examine what that
  16.  
  17. methodology recommends. The recommendations are particularly relevant to
  18.  
  19. ~H~bTutorialWriter~N, because the program was created around the ~C~IInstructional
  20.  
  21. Design~N methodology.
  22. #W
  23. %
  24. #EF
  25. #T
  26. #C2,R6
  27. The first two steps are the most important, because everything else you do
  28. will be influenced by them.
  29.  
  30.  
  31. ~HStep One~N is to ~C~Iidentify your audience~N. Who are you writing this for?
  32.  
  33.  
  34. ~HStep Two~N is to ~C~Istart at the end and work backwards~N.  What will the person you
  35. are writing this for know or be able to do by the time they have completed it?
  36. And be sure to answer in specific '~Haction~N' terms. The more '~R~Ifuzzy~N' the answers
  37. to this questions are, the more difficult it will be to write your ~M~Itutorial~N.
  38.  
  39. For example, if your answer is that they will '~R~Iappreciate fine art~N' as a
  40. result of taking your ~M~Itutorial~N, how will you decide what to teach them?
  41. But if you answer that they will '~Hbe able to identify a Van Gogh painting and
  42. explain his use of colors~N', this helps determine what information goes into
  43. your ~M~Itutorial~N.
  44. #WP
  45. %
  46. #EF
  47. #T
  48. #C2,R5
  49. Let's use a concrete example, because it is a lot easier to explain than using
  50. abstract concepts. We'll imagine that you have decided to write a ~M~Itutorial~N on
  51. ~HFrench Wines~N.
  52.  
  53. ~HStep One~N - Identify the Audience.
  54. The audience is ~HWine Snobs~N who want to show off their knowledge of French
  55. wines, usually in a loud voice at large gatherings.
  56.  
  57. ~HStep Two~N - what will they know or be able to do after taking your ~M~Itutorial~N?
  58. This is where you have to get specific. An answer like '~R~Iknow about French
  59. wines~N' is too '~R~Ifuzzy~N'. ~H~rYou need to develop a list of specific things~N.
  60.  
  61. 1. ~HThey will be able to distinguish a high quality wine from a lesser
  62.    quality wine by the bottle label~N.
  63.  
  64. 2. ~HThey will know the growing conditions and wine making history of 23
  65.    major Chateau wine producers~N.
  66.  
  67. And so on.
  68. #WP
  69. %
  70. #EF
  71. #T
  72. #C2,R5
  73. ~HOnce you have identified all the things they will know or be able to do,
  74. the hard work is almost over~N!!
  75.  
  76.  
  77. Look over your list and write down the information etc. you will need to
  78. give them for them to be able to do all the things on the list. As you are
  79. doing this, ~Hkeep the audience in mind~N. If they are already ~HWine Snobs~N on
  80. Californian wines, they may not need as much information. But if they are
  81. brand new, ~Htrainee Wine Snobs~N, you may have to tell them more.
  82.  
  83.  
  84. Review the information and decide whether you are writing an electronic
  85. '~G~Ipamphlet~N' or an electronic '~G~Ibook~N'.  The difference is that the '~G~Ipamphlet~N'
  86. is a single file, but the '~G~Ibook~N' has ~HChapters~N. ~H~bTutorialWriter~N can handle
  87. both.
  88.  
  89.  
  90. Let's assume that there is so much information that a '~G~Ibook~N' is needed. (If
  91. it is a '~G~Ipamphlet~N' it's the same as a single '~G~Ibook~N' ~HChapter~N).
  92. #WP
  93. %
  94. #EF
  95. #T
  96. #C2,R6
  97. Now split up the information you have listed into logical ~HChapters~N.
  98.  
  99. Here is one possible way.
  100.  
  101. ~H         1. History of French Winemaking
  102.          2. Wine Growing Regions in France
  103.          3. Red Wines.
  104.          4. White Wines.
  105.          5. Sparkling Wines.
  106.          6. How to Choose a Wine.~N
  107.  
  108.  
  109. Of course, there are other ways. You could divide it up on a geographical
  110.  
  111. basis - ~HWines of Bordeaux~N, ~HWines of Jura~N, ~HWines of the Gironde~N. But that is
  112.  
  113. your unique choice. There is no right or wrong way to divide it up.
  114. #WP
  115. %
  116. #EF
  117. #T
  118. #C2,R5
  119. Now you take one ~HChapter~N at a time and subdivide it into ~HSections~N, each
  120. covering a major topic.
  121.  
  122. Let's look at ~HChapter 2 - Wine Growing Regions in France~N.  From your
  123. information list you will know what ~G~IRegions~N you need to include and what
  124. kind of information you need to give about each one. Let's say that you need
  125. to tell where it is in France, how long wines have been grown there, climatic
  126. conditions, soil type, etc.
  127.  
  128. Each ~G~IRegion~N is now a ~HSection~N within that ~HChapter~N. So for each ~HSection~N you will
  129. list the specific information - 300 miles Southwest of Paris, on the Atlantic
  130. coast, wines have been grown there since the Romans conquered Gaul in 43 AD,
  131. wet and cool climate because of the Atlantic Ocean, flinty soil, etc.
  132.  
  133. After each ~HChapter~N has been worked through in this way, you will have
  134. structured your ~M~Itutorial~N and included all the information you need to pass
  135. on.
  136. #WP
  137. %
  138. #EF
  139. #T
  140. #C2,R5
  141. The next step is to decide how to present the information.
  142.  
  143.   1.  Start and end each ~HChapter~N with some interactive stuff - ~C~IQuizzes~N or
  144.       ~C~ITests~N - to provide incentive and feedback.
  145.  
  146. We will certainly want to end Chapter 2 with a ~C~Itest~N or ~C~Iquiz~N just to give
  147. feedback on how well the material has been learned.  But we might also
  148. want to start with one, maybe even the same one that we will give at the
  149. end, to whet the appetite for what will be presented.
  150.  
  151.  
  152.   2.  End each ~HSection~N with a ~C~IBranching Test~N to test the main points and
  153.       branch to corrective material if necessary.
  154.  
  155. At the end of each ~HSection~N, we will present a ~C~IBranching Test~N to see if the
  156. main ideas from that ~HSection~N have been picked up.  If the wrong answer is
  157. chosen, the program will jump to a '~G~Iremedial~N' screen to re-present the
  158. information.
  159. #WP
  160. %
  161. #EF
  162. #T
  163. #C2,R5
  164.   3.  Intersperse each ~HSection~N with interactive elements - ~C~Iquick questions~N,
  165.       ~C~Ipop-quizzes~N etc. to provide feedback.
  166.  
  167.  
  168. And just to make it interesting and to keep the reader motivated, we will
  169. ask a ~C~Iquick question~N every two or three screens - maybe even a ~C~Ipop-quiz~N
  170. with four or five questions to answer.  But we must be careful not to ask
  171. too many or the reader may get impatient to get on with the ~HChapter~N.
  172.  
  173.  
  174.   4.  Use ~C~IHilites~N to make the information interesting e.g ~C~Icolor~N, ~C~Isound~N,
  175.       ~C~IHypertext~N, ~C~Ipop-up windows~N etc.
  176.  
  177.  
  178. This is where individual taste is allowed full expression. We can use all
  179. kinds of effects here to make the information entertaining and interesting -
  180. ~C~Isliding screens~N, ~C~Iclickwriting~N, ~C~Ipop-up windows~N, the whole nine yards.
  181. #WP
  182. %
  183. #EF
  184. #T
  185. #C2,R5
  186.  
  187.  
  188.  
  189. A final point to consider is whether we should provide a ~C~IHELP system~N, perhaps
  190.  
  191. to tell the reader how to use ~C~IHyperText~N, or that a ~C~IMouse~N can be used, or to
  192.  
  193. press a key if they are finished reading a ~C~Ipop-up window~N, or whatever.
  194.  
  195.  
  196.  
  197.  
  198. And now look at ~HChapter 2~N in this ~M~Itutorial~N - ~C~IGETTING STARTED~N - to find out
  199.  
  200. the basics of using ~H~bTutorialWriter~N to create computer-based ~M~Itutorials~N.
  201. #WP
  202. #X
  203.